जावास्क्रिप्ट डेकोरेटर्स: एक्सेसर्स के साथ गुणों को बढ़ाना और मान्य करना

जावास्क्रिप्ट डेकोरेटर्स कक्षाओं और उनके सदस्यों को संशोधित करने और बढ़ाने का एक शक्तिशाली और सुरुचिपूर्ण तरीका प्रदान करते हैं, जिससे कोड अधिक पठनीय, रखरखाव योग्य और विस्तार योग्य बनता है। यह पोस्ट एक्सेसर्स (गेटर्स और सेटर्स) के साथ डेकोरेटर्स का उपयोग करके प्रॉपर्टी एन्हांसमेंट और वैलिडेशन की बारीकियों पर प्रकाश डालती है, जिसमें आधुनिक जावास्क्रिप्ट विकास के लिए व्यावहारिक उदाहरण और सर्वोत्तम अभ्यास प्रदान किए गए हैं।

जावास्क्रिप्ट डेकोरेटर्स क्या हैं?

ES2016 (ES7) में प्रस्तुत और मानकीकृत, डेकोरेटर्स एक डिज़ाइन पैटर्न हैं जो आपको मौजूदा कोड में एक घोषणात्मक और पुन: प्रयोज्य तरीके से कार्यक्षमता जोड़ने की अनुमति देते हैं। वे @ प्रतीक का उपयोग करते हैं जिसके बाद डेकोरेटर का नाम होता है और उन्हें कक्षाओं, विधियों, एक्सेसर्स या गुणों पर लागू किया जाता है। उन्हें सिंटैक्टिक शुगर के रूप में सोचें जो मेटाप्रोग्रामिंग को आसान और अधिक पठनीय बनाता है।

ध्यान दें: डेकोरेटर्स को आपके जावास्क्रिप्ट वातावरण में प्रायोगिक समर्थन सक्षम करने की आवश्यकता होती है। उदाहरण के लिए, टाइपस्क्रिप्ट में, आपको अपनी tsconfig.json फ़ाइल में experimentalDecorators कंपाइलर विकल्प को सक्षम करने की आवश्यकता है।

बुनियादी सिंटैक्स

एक डेकोरेटर अनिवार्य रूप से एक फ़ंक्शन है जो लक्ष्य (सजाई जा रही कक्षा, विधि, एक्सेसर, या संपत्ति), सजाए जा रहे सदस्य का नाम, और प्रॉपर्टी डिस्क्रिप्टर (एक्सेसर्स और विधियों के लिए) को आर्ग्यूमेंट्स के रूप में लेता है। यह तब लक्ष्य तत्व को संशोधित या प्रतिस्थापित कर सकता है।

            function MyDecorator(target: any, propertyKey: string, descriptor: PropertyDescriptor) {
  // Decorator logic here
}

class MyClass {
  @MyDecorator
  myProperty: string;
}

            

              
                Copy
              
            
          

डेकोरेटर्स और एक्सेसर्स (गेटर्स और सेटर्स)

एक्सेसर्स (गेटर्स और सेटर्स) आपको क्लास गुणों तक पहुंच को नियंत्रित करने की अनुमति देते हैं। एक्सेसर्स को डेकोरेट करना कार्यक्षमता जोड़ने के लिए एक शक्तिशाली तंत्र प्रदान करता है जैसे:

• सत्यापन: यह सुनिश्चित करना कि किसी गुण को दिया जा रहा मान कुछ मानदंडों को पूरा करता है।
• रूपांतरण: मान को संग्रहीत या वापस करने से पहले संशोधित करना।
• लॉगिंग: डिबगिंग या ऑडिटिंग उद्देश्यों के लिए गुणों तक पहुंच को ट्रैक करना।
• मेमोइज़ेशन: प्रदर्शन अनुकूलन के लिए गेटर के परिणाम को कैश करना।
• प्राधिकरण: उपयोगकर्ता भूमिकाओं या अनुमतियों के आधार पर गुणों तक पहुंच को नियंत्रित करना।

उदाहरण: वैलिडेशन डेकोरेटर

आइए एक डेकोरेटर बनाएं जो किसी गुण को सौंपे जा रहे मान को मान्य करता है। यह उदाहरण एक स्ट्रिंग के लिए एक साधारण लंबाई की जांच का उपयोग करता है, लेकिन इसे अधिक जटिल सत्यापन नियमों के लिए आसानी से अनुकूलित किया जा सकता है।

            function ValidateLength(minLength: number) {
  return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
    const originalSet = descriptor.set;

    descriptor.set = function (value: any) {
      if (typeof value === 'string' && value.length < minLength) {
        throw new Error(`Property ${propertyKey} must be at least ${minLength} characters long.`);
      }
      originalSet.call(this, value);
    };
  };
}

class User {
  private _username: string;

  @ValidateLength(3)
  set username(value: string) {
    this._username = value;
  }

  get username(): string {
    return this._username;
  }
}

const user = new User();

try {
  user.username = 'ab'; // This will throw an error
} catch (error) {
  console.error(error.message); // Output: Property username must be at least 3 characters long.
}

user.username = 'abc'; // This will work fine
console.log(user.username); // Output: abc

            

              
                Copy
              
            
          

स्पष्टीकरण:

1. ValidateLength डेकोरेटर एक फैक्ट्री फ़ंक्शन है जो न्यूनतम लंबाई को एक आर्ग्यूमेंट के रूप में लेता है।
2. यह एक डेकोरेटर फ़ंक्शन लौटाता है जो target, propertyKey (गुण का नाम), और descriptor प्राप्त करता है।
3. डेकोरेटर फ़ंक्शन मूल सेटर (descriptor.set) को इंटरसेप्ट करता है।
4. इंटरसेप्ट किए गए सेटर के अंदर, यह सत्यापन जांच करता है। यदि मान अमान्य है, तो यह एक त्रुटि फेंकता है। अन्यथा, यह originalSet.call(this, value) का उपयोग करके मूल सेटर को कॉल करता है।

उदाहरण: ट्रांसफॉर्मेशन डेकोरेटर

यह उदाहरण दिखाता है कि किसी मान को किसी गुण में संग्रहीत करने से पहले उसे कैसे बदला जाए। यहां, हम एक डेकोरेटर बनाएंगे जो स्वचालित रूप से एक स्ट्रिंग मान से व्हाइटस्पेस को ट्रिम करता है।

            function Trim() {
  return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
    const originalSet = descriptor.set;

    descriptor.set = function (value: any) {
      if (typeof value === 'string') {
        value = value.trim();
      }
      originalSet.call(this, value);
    };
  };
}

class Product {
  private _name: string;

  @Trim()
  set name(value: string) {
    this._name = value;
  }

  get name(): string {
    return this._name;
  }
}

const product = new Product();
product.name = '  My Product  ';
console.log(product.name); // Output: My Product

            

              
                Copy
              
            
          

स्पष्टीकरण:

1. Trim डेकोरेटर name गुण के सेटर को इंटरसेप्ट करता है।
2. यह जांचता है कि सौंपा जा रहा मान एक स्ट्रिंग है या नहीं।
3. यदि यह एक स्ट्रिंग है, तो यह अग्रणी और अनुगामी व्हाइटस्पेस को हटाने के लिए trim() विधि को कॉल करता है।
4. अंत में, यह ट्रिम किए गए मान के साथ मूल सेटर को कॉल करता है।

उदाहरण: लॉगिंग डेकोरेटर

यह उदाहरण दिखाता है कि किसी गुण तक पहुंच को कैसे लॉग किया जाए, जो डिबगिंग या ऑडिटिंग के लिए उपयोगी हो सकता है।

            function LogAccess() {
  return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
    const originalGet = descriptor.get;
    const originalSet = descriptor.set;

    if (originalGet) {
      descriptor.get = function () {
        const result = originalGet.call(this);
        console.log(`Getting ${propertyKey}: ${result}`);
        return result;
      };
    }

    if (originalSet) {
      descriptor.set = function (value: any) {
        console.log(`Setting ${propertyKey} to: ${value}`);
        originalSet.call(this, value);
      };
    }
  };
}

class Configuration {
  private _apiKey: string;

  @LogAccess()
  set apiKey(value: string) {
    this._apiKey = value;
  }

  get apiKey(): string {
    return this._apiKey;
  }
}

const config = new Configuration();
config.apiKey = 'your_api_key'; // Output: Setting apiKey to: your_api_key
console.log(config.apiKey); // Output: Getting apiKey: your_api_key
                              // Output: your_api_key

            

              
                Copy
              
            
          

स्पष्टीकरण:

1. LogAccess डेकोरेटर apiKey गुण के गेटर और सेटर दोनों को इंटरसेप्ट करता है।
2. जब गेटर को कॉल किया जाता है, तो यह प्राप्त मान को कंसोल पर लॉग करता है।
3. जब सेटर को कॉल किया जाता है, तो यह कंसोल पर सौंपे जा रहे मान को लॉग करता है।

व्यावहारिक अनुप्रयोग और विचार

एक्सेसर्स के साथ डेकोरेटर्स का उपयोग विभिन्न परिदृश्यों में किया जा सकता है, जिनमें शामिल हैं:

• डेटा बाइंडिंग: किसी गुण के बदलने पर UI को स्वचालित रूप से अपडेट करना। एंगुलर और रिएक्ट जैसे फ्रेमवर्क अक्सर आंतरिक रूप से समान पैटर्न का उपयोग करते हैं।
• ऑब्जेक्ट-रिलेशनल मैपिंग (ORM): यह परिभाषित करना कि क्लास गुण डेटाबेस कॉलम से कैसे मैप होते हैं, जिसमें सत्यापन नियम और डेटा परिवर्तन शामिल हैं। उदाहरण के लिए, एक डेकोरेटर यह सुनिश्चित कर सकता है कि एक स्ट्रिंग गुण डेटाबेस में लोअरकेस के रूप में संग्रहीत हो।
• एपीआई एकीकरण: बाहरी एपीआई से प्राप्त डेटा को मान्य और परिवर्तित करना। एक डेकोरेटर यह सुनिश्चित कर सकता है कि एपीआई से प्राप्त एक दिनांक स्ट्रिंग को एक मान्य जावास्क्रिप्ट Date ऑब्जेक्ट में पार्स किया गया है।
• कॉन्फ़िगरेशन प्रबंधन: पर्यावरण चर या कॉन्फ़िगरेशन फ़ाइलों से कॉन्फ़िगरेशन मान लोड करना और उन्हें मान्य करना। उदाहरण के लिए, एक डेकोरेटर यह सुनिश्चित कर सकता है कि एक पोर्ट नंबर एक वैध सीमा के भीतर है।

विचारणीय बातें:

• जटिलता: डेकोरेटर्स का अत्यधिक उपयोग कोड को समझना और डीबग करना कठिन बना सकता है। उनका विवेकपूर्ण उपयोग करें और उनके उद्देश्य को स्पष्ट रूप से प्रलेखित करें।
• प्रदर्शन: डेकोरेटर्स अप्रत्यक्षता की एक अतिरिक्त परत जोड़ते हैं, जो संभावित रूप से प्रदर्शन को प्रभावित कर सकती है। अपने कोड के प्रदर्शन-महत्वपूर्ण वर्गों को मापें ताकि यह सुनिश्चित हो सके कि डेकोरेटर्स महत्वपूर्ण मंदी का कारण नहीं बन रहे हैं।
• संगतता: जबकि डेकोरेटर्स अब मानकीकृत हैं, पुराने जावास्क्रिप्ट वातावरण उन्हें मूल रूप से समर्थन नहीं कर सकते हैं। विभिन्न ब्राउज़रों और Node.js संस्करणों में संगतता सुनिश्चित करने के लिए बेबेल या टाइपस्क्रिप्ट जैसे ट्रांसपाइलर का उपयोग करें।
• मेटाडेटा: डेकोरेटर्स का उपयोग अक्सर मेटाडेटा रिफ्लेक्शन के साथ किया जाता है, जो आपको रनटाइम पर सजाए गए सदस्यों के बारे में जानकारी तक पहुंचने की अनुमति देता है। reflect-metadata लाइब्रेरी मेटाडेटा जोड़ने और पुनर्प्राप्त करने का एक मानकीकृत तरीका प्रदान करती है।

उन्नत तकनीकें

रिफ्लेक्ट एपीआई का उपयोग करना

रिफ्लेक्ट एपीआई शक्तिशाली आत्मनिरीक्षण क्षमताएं प्रदान करता है, जो आपको रनटाइम पर वस्तुओं के व्यवहार का निरीक्षण और संशोधन करने की अनुमति देता है। इसका उपयोग अक्सर डेकोरेटर्स के साथ कक्षाओं और उनके सदस्यों में मेटाडेटा जोड़ने के लिए किया जाता है।

उदाहरण:

            import 'reflect-metadata';

const formatMetadataKey = Symbol('format');

function format(formatString: string) {
  return Reflect.metadata(formatMetadataKey, formatString);
}

function getFormat(target: any, propertyKey: string) {
  return Reflect.getMetadata(formatMetadataKey, target, propertyKey);
}

class Greeter {
  @format('Hello, %s')
  greeting: string;

  constructor(message: string) {
    this.greeting = message;
  }

  greet() {
    let formatString = getFormat(this, 'greeting');
    return formatString.replace('%s', this.greeting);
  }
}

let greeter = new Greeter('world');
console.log(greeter.greet()); // Output: Hello, world

            

              
                Copy
              
            
          

स्पष्टीकरण:

1. हम reflect-metadata लाइब्रेरी आयात करते हैं।
2. हम नामकरण टकराव से बचने के लिए एक Symbol का उपयोग करके एक मेटाडेटा कुंजी को परिभाषित करते हैं।
3. format डेकोरेटर greeting गुण में मेटाडेटा जोड़ता है, प्रारूप स्ट्रिंग को निर्दिष्ट करता है।
4. getFormat फ़ंक्शन किसी गुण से जुड़े मेटाडेटा को पुनः प्राप्त करता है।
5. greet विधि मेटाडेटा से प्रारूप स्ट्रिंग को पुनः प्राप्त करती है और इसका उपयोग अभिवादन संदेश को प्रारूपित करने के लिए करती है।

डेकोरेटर्स को कंपोज़ करना

आप एक ही एक्सेसर पर कई संवर्द्धन लागू करने के लिए कई डेकोरेटर्स को जोड़ सकते हैं। यह आपको जटिल सत्यापन और परिवर्तन पाइपलाइन बनाने की अनुमति देता है।

उदाहरण:

            function ToUpperCase() {
  return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
    const originalSet = descriptor.set;

    descriptor.set = function (value: any) {
      if (typeof value === 'string') {
        value = value.toUpperCase();
      }
      originalSet.call(this, value);
    };
  };
}

@ValidateLength(5)
@ToUpperCase()
class DataItem {
  private _value: string;

  set value(newValue: string) {
    this._value = newValue;
  }

  get value(): string {
    return this._value;
  }
}

const item = new DataItem();
try {
  item.value = 'short'; // This will throw an error because it's shorter than 5 characters.
} catch (e) {
  console.error(e.message); // Property value must be at least 5 characters long.
}

item.value = 'longer';
console.log(item.value); // LONGER

            

              
                Copy
              
            
          

इस उदाहरण में, `ValidateLength` डेकोरेटर पहले लागू किया जाता है, उसके बाद `ToUpperCase` आता है। डेकोरेटर अनुप्रयोग का क्रम मायने रखता है; यहाँ स्ट्रिंग को अपरकेस में बदलने से *पहले* लंबाई को मान्य किया जाता है।

सर्वोत्तम अभ्यास

• डेकोरेटर्स को सरल रखें: डेकोरेटर्स को केंद्रित होना चाहिए और एक एकल, अच्छी तरह से परिभाषित कार्य करना चाहिए। अत्यधिक जटिल डेकोरेटर्स बनाने से बचें जिन्हें समझना और बनाए रखना मुश्किल है।
• फैक्ट्री फंक्शंस का उपयोग करें: ऐसे डेकोरेटर्स बनाने के लिए फैक्ट्री फंक्शंस का उपयोग करें जो आर्ग्यूमेंट्स स्वीकार करते हैं, जिससे आप उनके व्यवहार को अनुकूलित कर सकते हैं।
• अपने डेकोरेटर्स को प्रलेखित करें: अपने डेकोरेटर्स के उद्देश्य और उपयोग को स्पष्ट रूप से प्रलेखित करें ताकि उन्हें अन्य डेवलपर्स द्वारा समझना और उपयोग करना आसान हो सके।
• अपने डेकोरेटर्स का परीक्षण करें: यह सुनिश्चित करने के लिए यूनिट परीक्षण लिखें कि आपके डेकोरेटर्स सही ढंग से काम कर रहे हैं और वे कोई अप्रत्याशित दुष्प्रभाव नहीं डाल रहे हैं।
• साइड इफेक्ट्स से बचें: डेकोरेटर्स को आदर्श रूप से शुद्ध फ़ंक्शन होना चाहिए जिनका लक्ष्य तत्व को संशोधित करने के बाहर कोई साइड इफेक्ट नहीं होता है।
• अनुप्रयोग के क्रम पर विचार करें: कई डेकोरेटर्स को कंपोज़ करते समय, उस क्रम पर ध्यान दें जिसमें वे लागू होते हैं, क्योंकि यह परिणाम को प्रभावित कर सकता है।
• प्रदर्शन के प्रति सचेत रहें: अपने डेकोरेटर्स के प्रदर्शन प्रभाव को मापें, खासकर अपने कोड के प्रदर्शन-महत्वपूर्ण वर्गों में।

वैश्विक परिप्रेक्ष्य

प्रॉपर्टी एन्हांसमेंट और वैलिडेशन के लिए डेकोरेटर्स का उपयोग करने के सिद्धांत दुनिया भर में विभिन्न प्रोग्रामिंग प्रतिमानों और सॉफ्टवेयर विकास प्रथाओं पर लागू होते हैं। हालाँकि, विशिष्ट संदर्भ और आवश्यकताएं उद्योग, क्षेत्र और परियोजना के आधार पर भिन्न हो सकती हैं।

उदाहरण के लिए, वित्त या स्वास्थ्य सेवा जैसे भारी विनियमित उद्योगों में, कड़े डेटा सत्यापन और सुरक्षा आवश्यकताओं के लिए अधिक जटिल और मजबूत सत्यापन डेकोरेटर्स के उपयोग की आवश्यकता हो सकती है। इसके विपरीत, तेजी से विकसित हो रहे स्टार्टअप्स में, ध्यान तेजी से प्रोटोटाइप और पुनरावृत्ति पर हो सकता है, जिससे सत्यापन के लिए अधिक व्यावहारिक और कम कठोर दृष्टिकोण हो सकता है।

अंतर्राष्ट्रीय टीमों में काम करने वाले डेवलपर्स को सांस्कृतिक मतभेदों और भाषा बाधाओं के प्रति भी सचेत रहना चाहिए। सत्यापन नियम परिभाषित करते समय, विभिन्न देशों में उपयोग किए जाने वाले विभिन्न डेटा प्रारूपों और परंपराओं पर विचार करें। उदाहरण के लिए, दिनांक प्रारूप, मुद्रा प्रतीक, और पता प्रारूप विभिन्न क्षेत्रों में काफी भिन्न हो सकते हैं।

निष्कर्ष

एक्सेसर्स के साथ जावास्क्रिप्ट डेकोरेटर्स गुणों को बढ़ाने और मान्य करने, कोड की गुणवत्ता, रखरखाव और पुन: प्रयोज्यता में सुधार करने का एक शक्तिशाली और लचीला तरीका प्रदान करते हैं। डेकोरेटर्स, एक्सेसर्स और रिफ्लेक्ट एपीआई के मूल सिद्धांतों को समझकर, और सर्वोत्तम प्रथाओं का पालन करके, आप मजबूत और अच्छी तरह से डिज़ाइन किए गए एप्लिकेशन बनाने के लिए इन सुविधाओं का लाभ उठा सकते हैं।

अपने प्रोजेक्ट के विशिष्ट संदर्भ और आवश्यकताओं पर विचार करना याद रखें, और तदनुसार अपने दृष्टिकोण को अनुकूलित करें। सावधानीपूर्वक योजना और कार्यान्वयन के साथ, डेकोरेटर्स आपके जावास्क्रिप्ट विकास शस्त्रागार में एक मूल्यवान उपकरण हो सकते हैं।